.Dd 5 August 2010
.Dt SIEVELOG 1
.Os
.Sh NAME
.Nm sievelog
.Nd syslog message filter
.Sh SYNOPSIS
.Nm
.Op Fl otD
.Op Fl P Ar prof_file
.Op Fl R Ar directory
.Ao Ar sievefile Ac
.Sh DESCRIPTION
.Nm
is a rules based message dispatcher. It reads newline-delimited messages on its
standard input and uses a set of rules specified in
.Ar sievefile .
to direct them to files or to email them. The rule syntax is documented in
.Xr sievelog.conf 5 .

The options are as follows:
.Bl -tag -width indent
.It Fl o
Activate the ruleset optimizer. This dynamically sorts the rules such that the
most frequently matched rules are tried first.
.It Fl t
Only do a syntax check of
.Ar sievefile .
.It Fl D
Activate debugging output. This is only sane when used in combination with
.Fl t .
.
.It Fl P Ar prof_file
Dump profiling data to
.Ar prof_file
when a SIGINFO is received.
.It Fl R Ar directory
Restrict the rules in
.Ar sievefile
to only writing into
.Ar directory
or its descendants.
.Sh SEE ALSO
.Xr sievelog.conf 5
.Sh AUTHORS
.An Jesse Kempf (jessekempf@gmail.com)
.Sh BUGS
The
.Fl P
option can only write to a file, not a named pipe or Unix domain socket.
